home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / commo50.arc / UPGRADE.DOC < prev    next >
Text File  |  1991-09-05  |  4KB  |  110 lines
  1.  
  2.                      {COMMO} 4.x to 5.x Upgrade Guide
  3.                      --------------------------------
  4.  
  5.  
  6. Upgrading is very easy if you follow the instructions below.  These changes
  7. will bring you up to date.  Then you will probably want to take advantage of
  8. the new features to greatly increase the power of your macros.
  9.  
  10.  
  11. Configuration File
  12. ------------------
  13.  
  14. COMMO.CFG has been replaced with COMMO.SET.  All items in this new file are
  15. "keyworded."  This means that in the future you will only have to add an item
  16. or two to become current.  You won't have to redo the entire file any more.
  17.  
  18. The easiest way to upgrade to the new Setup File is to print out your
  19. Configuration File.  Then start {COMMO} 5.x and press Alt-G to edit the Setup
  20. File.  Change any items as needed, then exit and restart {COMMO} (the Setup
  21. File is processed only at startup now).
  22.  
  23.  
  24. Dialing Directory
  25. -----------------
  26.  
  27. You will only need to change your Dialing Directory if you have used any
  28. alternate Dialing Prefixes -- #1, #2, #3 or #4.
  29.  
  30. The Dialing Prefix items in the Configuration File are gone, but you may now
  31. establish String Variables to have as many prefixes (or suffixes) as desired.
  32. For example, suppose you had this in 4.x:
  33.  
  34.         23 * {AT U1 DT}        Dial Prefix #2
  35.  
  36. and you had a Dialing Directory entry:
  37.  
  38.         Joes-BBS        {#2 555-1234} {pword} ...
  39.  
  40. In 5.x you would put the following in your Setup File:
  41.  
  42.         {set prefix2,AT U1 DT}   Alternate prefix
  43.  
  44. You could use a variable name of your choice instead of "prefix2."
  45.  
  46. Finally, in your Dialing Directory change the entry to:
  47.  
  48.         Joes-BBS        {%prefix2% 555-1234} {pword} ...
  49.  
  50.  
  51. Macro File
  52. ----------
  53.  
  54. Macro labels (they used to be called macro-id's) must now begin with a colon
  55. (:).  They may also be made up of one or more characters, of which the first
  56. eight are significant.
  57.  
  58. So just change all your macro labels from {abc} to {:abc}, etc., for now.
  59.  
  60. The EXECute "%" parameters have all been replaced with String Variables or
  61. with Function Switches.  Here is a list of parameters and what to change them
  62. to:
  63.  
  64.  Old Parameter   Change to
  65.  -------------   ---------
  66.  
  67.         %a      Use "A" switch:  EXEC-A ...
  68.         %w      Use "W" switch:  EXEC-W ...
  69.         %p      %_port   (or %_por)
  70.         %s      %_speed  (or %_spe)
  71.         %m      %_modem  (or %_mod)
  72.         %c      %_cap
  73.         %u      String variable, "%uldir" for example.
  74.         %d      String variable, "%dldir" for example.
  75.         %k      Control character, e.g. change "%k^L" to just "^L".
  76.         %i      Use INPUt function prior to EXEC.  See example
  77.                 below.
  78.  
  79. EXED and EXEN are no longer valid functions and must be specified with
  80. Function Switches.  Change EXED to EXEC-D and EXEN to EXEC-N.
  81.  
  82. Note that Function Switches may be used in any combination.  Here is an
  83. example of a macro to upload a file using Zmodem with DSZ:
  84.  
  85.  ZMODEM batch   {:af2} {setv file,%uldir\}
  86.                 {input file,Enter a filename to UPLOAD}
  87.                 {exec-AWD c:\proto\DSZ.com port %_port sz -m %file} {}
  88.  
  89. This sets the temporary variable "file" to the upload directory "uldir".  The
  90. INPUt function will display the current value of "file" in the input line
  91. (with the cursor at the end).
  92.  
  93. Then DSZ will be run (direct, because of the "D" switch).  The contents of the
  94. variable "file" will be used for the filename.  After DSZ executes, the alarm
  95. will sound ("A" switch) and {COMMO} will wait for a key press ("W" switch) so
  96. you can see the results.
  97.  
  98.  
  99. A few other functions now have Function Switches to replace other parameters:
  100.  
  101.  Change                         To
  102.  ------                         --
  103.  
  104.  {dial 5,abc,c}                 {dial-C 5,abc}
  105.  {macload other.mac,abc,r}      {macload-R other.mac,abc}
  106.  {doorway s}                    {doorway-S}
  107.  
  108.  
  109.                                 - end -
  110.